LIFEOGRAPHDB
V 110
E no

O -d
l en_US
S 10009
L 10022
ID10016
t stub
ID10018
oe2147485696	Advanced
ID10011
oe2147484672	Intermediate
ID10010
oe2147483648	Basics
ID10002
CcDefault

ID10032
E 2147485701
Dr1383064691
Dh1383065055
P Diary File Version Support
P 
P Below is a table showing which diary file versions can be opened and saved by a particular Lifeograph version.
P 
P  0.5.6 - 0.6.4
P 	• *Reads:*	37-56
P 	• *Writes:*	56
P 
P  0.7.0
P 	• *Reads:*	51-56
P 	• *Writes:*	56
P 
P  0.7.1, 0.7.2
P 	• *Reads:*	56
P 	• *Writes:*	56
P 
P  0.7.3
P 	• *Reads:*	56,73
P 	• *Writes:*	73
P 
P  0.7.4 - 0.10.0
P 	• *Reads:*	56-74
P 	• *Writes:*	74
P 
P  0.11.0 - 1.0.0
P 	• *Reads:*	56-110
P 	• *Writes:*	110

ID10029
E 2147485700
Dr1359488053
Dh1359489009
T stub
P Encryption
P 
P Lifeograph uses <http://en.wikipedia.org/wiki/Aes256	AES256 algorithm> via <http://www.gnu.org/software/libgcrypt/	libgcrypt> for encrypted diaries.
P 
P This is real encryption. So, there is no known way of recovering the data in an encrypted diary when its password is lost -except for trial and error.

ID10017
E 2147485699
Dr1337552255
Dh1354357524
P Hidden Options
P 
P  Diary file extension
P To override the default value (.diary) add a line to lifeo.conf starting with E.
P e.g. to change to .lifeograph (Please note that any custom extension should begin with a dot):
P 
P E .lifeograph
P 
P and to disable automatic appendage of an extension use just a dot:
P 
P E .

ID10020
E 2147485698
Dr1341263079
Dh1349123917
P Command-line Options
P 
P  SYNOPSIS
P        lifeograph [--force-welcome] [--open, -o _DIARY_] [--read-only]
P 
P  OPTIONS
P *--open*, *-o* _DIARY_
P Sets  the  diary  file  to be opened. If the diary is encrypted, Lifeograph will start with a password prompt.
P 
P *--read-only*, *-r*
P Open the command-line supplied file in read-only mode  if  there is one.
P 
P *--ignore-locks*
P Enables  opening locked diary files. Beware that if a diary file is locked it is probably being edited  by  another  instance  of Lifeograph or the last session with it did not finish correctly. In either case the lock file may contain unsaved changes.
P 
P *--force-welcome*
P Forces program to show  the  welcome  screen.  Normally  welcome screen is only shown on the first run of Lifeograph.

ID10023
E 2147485697
Dr1341266304
Dh1354357421
P Backup Files
P 
P Lifeograph saves two backup files. Both are saved in the same directory as the diary file. Their names are <DIARYNAME>.~LOCK~ and <DIARYNAME>.~previousversion~.
P The first one is saved twice a minute during an editing session and contains all unsaved changes up to that time. It is, however, deleted after logging out successfully.
P The second one is saved at log-out and is simply a backup of the diary before the last editing session.
P 
P  Recovery after crashes
P <DIARYNAME>.~LOCK~ is useful to recover unsaved changes after crashes. When, due to a crash or any other reason, a Lifeograph session ends improperly the .~LOCK~ file will not be removed. In that case, Lifeograph will refuse to open the original diary again complaining that it is locked.
P If the presence of the lock is due to quitting improperly (rather than the file's being open in another instance of Lifeograph) you can rename the lock file and open it with Lifeograph to recover the unsaved changes. If you are sure that you don't want to restore the changes you can simply delete the lock file and open the original diary.
P 
P <DIARYNAME>.~previousversion~ can be used to revert changes made in the last editing session.

ID10031
E 2147484682
Dr1377870243
Dh1377871162
P Read-Only Mode
P 
P Lifeograph opens diaries in Read-only mode when
P 	• the user does not have write permissions on the diary file,
P 	• the file is a system diary, such as Lifeograph Manual, or
P 	• the user choses so, usually for preventing accidental changes on the diary.
P 
P  Differences between Read and Edit modes
P In read-only mode,
P 	• editing functionality elements are hidden, resulting in a much simple user interface,
P 	• links are activated without pressing Ctrl and selected with pressing it,
P 	• markup characters are always hidden,
P 	• spell checking is always disabled.
P 
P 
P 
P 
P 
P 

ID10026
E 2147484681
Dr1349541098
Dh1360177163
P Settings
P 
P rel://images/settings.gif
P 
P  Logging out when idle
P Lifeograph can save the current diary and log out when a configurable time has passed without any user interaction. This only happens when the opened diary is encrypted.
P 
P  Formatting toolbar
P Formatting toolbar (which is the one with bold, italic, etc... buttons) can be hidden to reclaim some more screen real estate. Note that, all the functionality in the toolbar is also accessible via <deid:10008	Keyboard Shortcuts>.

ID10019
E 2147484680
Dr1349123755
Dh1360177393
P Printing
P 
P  Lifeograph specific options
P Lifeograph specific options can be found on the *Lifeograph* tab of the print dialog:
P 
P rel://images/printing.gif
P 
P  What to print?
P It is possible to print the current entry, filtered entries (if a filter is in progress) or the entire diary.
P 
P  Text options
P The default font for the print out is configurable here. Optionally it is also possible to print each entry in its theme's font.
P The last option is for justifying the text on the page. Normally text is left aligned.

ID10028
E 2147484679
Dr1354958522
Dh1360009521
T stub
P Importing
P 
P It is possible to merge diaries by importing entries, tags, and themes from another diary.
P 
P Import dialog can be opened from the gear menu of the <deid:10021	diary view>.
P 

ID10025
E 2147484678
Dr1341429541
Dh1377869660
T stub
P Exporting (Saving a Copy of) the Diary
P 
P It is possible to save a complete or partial copy of the current diary as either another diary file or as a plain text file.
P 
P Export dialog can be opened from the gear menu of the <deid:10004	diary view>.
P 
P Lifeograph will ask for the password before exporting an encrypted diary.
P 
P  Exporting to plain text file
P Plain text files can be used as a future-proof back-up format or for sharing diaries with other people who do not use Lifeograph.
P 
P  Exporting to a Lifeograph diary file
P This can be used for saving a copy of the current diary either as a whole or partially as per the active entry filters. Encryption is optional and a different password can be selected than that of the original file.
P 
P  Exporting to PDF
P Although Lifeograph does not support exporting to PDF directly, printing to file facility can be used for that very purpose.

ID10027
E 2147484677
Dr1354449009
Dh1354450412
T stub
P Spell Checking
P 
P Lifeograph supports spell-checking utilizing _Enchant_ library.
P 
P To enable spell checking go to <deid:10004	diary view> and select a language from the *Spell Checking* combo box.
P 
P If needed, spell checking preference set for the diary can be overridden for any particular entry. To do this, open the entry and right-click in the text editor. Select the desired option from the *Spell Checking* sub-menu.
P Diary Default option removes the override from the entry.

ID10015
E 2147484676
Dr1330897444
Dh1354957699
T stub
P Lists in Entries
P 
P If you indent the line, either by Alt-I or <tab>, you can create different kinds of lists depending on the first character(s) you type:
P 
P     Bulleted lists by typing '*'.
P     Enumerated lists by typing a number followed by '.', ')', or '-'.
P     Checklists by typing '[]'.
P 
P It is also possible to convert the current line (or multiple lines at once when text selection covers multiple lines) to bullet or check list items by using the dedicated buttons in the Entry formatting toolbar.
P 
P  Bulleted lists
P 
P 	• Item 1
P 	• Item 2
P 
P  Checklists
P Lifeograph has basic checklist support. Each checklist item may have one of the three possible states:
P 
P 	☐ not finished
P 	☑ finished
P 	☒ canceled
P 
P State of an item can be changed by clicking on the check box of it. Highlight and strike-through styles are applied automatically for finished and canceled items, respectively.
P 
P  Numbered lists
P Lifeograph has very basic support for numbered lists in that it automatically inserts the next number to the beginning of a new line if previous line is a valid numbered list line (i.e. starts with a <tab><number><separator> sequence where separator is " *)* " " *-* " or " *.* " ).
P 
P 	1- item 1
P 	2- item 2
P 	3- item 3
P 

ID10022
E 2147484675
Dr1341265720
Dh1360177073
T stub
P Text Formatting
P 
P  Heading (Entry title)
P First paragraph of an entry (i. e. any text before the first line break) is considered the title rendered in heading style. Other formats (such as highlight) cannot be used within entry titles nor are comments. Color of heading is defined by  associated theme.
P 
P  Subheading
P Paragraphs starting with a single space (" ") are styled as subheading. Other formats and comments can be used normally in subheadings however using bold will make no difference as subheading style is already bold. Color of subheading comes from  associated theme.
P 
P  Markup chars
P Lifeograph has a text formatting system reminiscent of wiki software i.e. certain characters are used to denote different text styles. These are called _markup characters_.
P 
P *bold*: asterisk *
P 
P _italic_: underscore _
P 
P =strike-through=: equal sign =
P 
P #Highlight#: hash #
P 
P 	• Markup characters are normally hidden. They are only shown when input cursor is placed adjacent to their location.
P 	• Markup characters should be inserted at the beginning and end of the part of the text you want to apply formatting
P 	• Opening markup characters must came after a *separator* but mustn't be followed by one. (Separator is a character to separate words such as space or tab.)
P 	• Closing markup characters mustn't come after a separator
P 	• Highlight color is defined by entry theme.

ID10014
E 2147484674
Dr1330895860
Dh1354956776
T stub
P Filtering and Replacing
P 
P Entries can be filtered by
P 	• having a tag,
P 	• coming before or after a particular date,
P 	• containing some text, and
P 	• being favorite.
P 
P These filters can be combined to achieve a finer result.
P Additionally any single entry can be hidden/filtered out to further tweak the list of displayed entries according to any purpose.
P 
P  Use cases of filtering
P Hiding some entries by means of filters has two main uses: finding things looked for without browsing too much and limiting effects of some operations (such as exporting and <deid:10019	Printing>) to a subset of entries in the diary.
P 
P A third use related to filtering by text is replacing certain text blocks with something else.

ID10012
E 2147484673
Dr1329596926
Dh1377870967
P Links
P 
P Links can be given to many types of objects, such as dates, web sites, email addresses, and diary elements.
P 
P Links can be followed by holding Ctrl key when clicking on them. This behavior is reversed in <deid:10031	Read-Only Mode>.
P 
P Basically there are two types of links: automatic and manual. 
P 
P  Automatic links
P Certain expressions are recognized and automatically converted into links such as
P 	• urls starting with
P 		• http://
P 		• https://
P 		• ftp://
P 		• file://
P 	• e-mail addresses with @ sign
P 	• dates in YYYY.MM.DD format (Note that besides dots, slashes and dashes can also be used as separators in dates)
P 
P e.g.:
P 	http://launchpad.net/lifeograph
P 	e-mail@address.com
P 	2012.12.01, 2012/12/01, 2012-12-01
P 
P  Relative links
P For file links, rather than providing a full path, it is also possible to enter link paths relative to the location of the diary. Such links are formed by using a special prefix:
P 	rel://
P 
P e.g.:
P 	rel://example.diary
P 
P  Manual links
P Besides special tokens, any type of text can be converted into a link by using a special syntax:
P 
P <target	label>
P 
P where target is any type of link that is recognized by automatic link mechanism explained above or id of an entry. Please note that target and label are separated by a single *tab* character.
P 
P e.g.:
P <2012.03.31	his birth day>
P .	<2012.03.31	his birth day>
P 
P <deid:10009	Welcome Page>
P .	<deid:10009	Welcome Page>
P 
P Second example above shows the usage of an entry ID as a target. Every entry in a diary has a unique ID that never changes. However, users are not supposed to know entry IDs. The normal way of creating such links is dropping entries from list into the entry text.

ID10008
E 2147483659
Dr1315862697
Dh1360177056
P Keyboard Shortcuts
P 
P  General
P 	• *Log out:* Ctrl + Escape
P 	• *Focus filtering control:* Ctrl + F
P 
P  Text Editing
P 	• *Undo:* Ctrl + Z
P 	• *Redo:* Ctrl + Shift + Z
P 
P 	• *Bold:*	#Ctrl + B#
P 	• *Highlight:* #Ctrl + H#
P 	• *Italic:* #Ctrl + I#
P 	• *Strike-through:* #Ctrl + S#
P 
P 	• *Toggle visibility of comments:* #Alt + C#
P 	• *Indent:* #Alt + I#
P 	• *Unindent:* #Alt + U#
P 	• *Insert empty line above:* #Alt + L#
P 	• *Erase empty line above:* #Alt + Shift + L#
P 	• *Move current paragraph up:* #Alt + Up#
P 	• *Move current paragraph down:* #Alt + Down#
P 
P 	• *Insert current date and time:* #Alt + T#
P  
P 	• *Focus tag widget:* #Ctrl + T#
P 
P #Highlighted# shortcuts can only be used when focus is on entry text.
P 
P  Navigation
P 	• *Go to the previous entry in the list:* Ctrl + Page Down
P 	• *Go to the next entry in the list:* Ctrl + Page Up
P 	• *Go to the previous entry in browsing history:* Alt + Left
P 	• *Go to today:* Ctrl + D
P 	• *Jump to current entry in the list:* Ctrl + J

ID10006
E 2147483658
Dr1315863045
Dh1354224327
T stub
P Themes
P 
P Font and colors used in entries can be customized via so called themes. Themes are saved in diaries and there is no limit for the number of themes in a diary file. 
P 
P  System theme: [ - 0 - ]
P Every diary has a system theme which inherits its features mostly from operating system theme and cannot be edited by the user.
P 
P  Default theme
P The theme used in entries that no theme is assigned to.
P 
P  Usage
P New themes are created by duplicating existing ones. A theme is assigned to the current entry by dropping it from the theme list onto the entry text.

ID10013
E 2147483657
Dr1330895758
Dh1341431465
T stub
P Topics
P 
P Topics are like chapters but they are not time based thus they are used to group time independent entries.
P 
P To create a topic, click the *new* icon in the <deid:10024	main tool bar> and select _Topic_ from the drop down list.

ID10007
E 2147483656
Dr1315862841
Dh1359487299
T stub
P Chapters
P 
P Chapter system is a means of organizing entries according to phases in our lives. This will make it a lot more convenient to manage a diary with hundreds of entries.
P 
P  Creating chapters
P 	• Select the day the Chapter will begin in the calendar
P 	• From the *New* button in the main tool bar select *Chapter*
P 
P  Chapter categories
P Chapters themselves are grouped in so called Chapter categories, to allow unlimited grouping schemes according to different aspects of life.
P More than one set of chapters can be defined within a diary file.  Only one chapter category is active at a time.
P 
P Chapter categories are managed in <deid:10024	diary view>:
P 
P rel://images/chapter_ctg.gif
P 
P  Usage of chapter categories
P e.g. one can create a chapter set called Jobs with chapters for companies she has worked for and another one called Places that contains chapters for cities she has lived in.
P 
P 

ID10005
E 2147483655
Dr1315863054
Dh1375517686
T stub
P Tags
P 
P Tags are user defined attributes in a diary that entires can be associated with. There is no limit for the number tags a diary can hold.
P 
P Tags can be added to the current entry by dropping them onto the entry text or by typing their name into the *Tag name* field which is opened by clicking *Add Tag* in the entry's tag list or by using the shortcut Ctrl + T. Entering only part of the tag name is sufficient as Lifeograph will suggest tags containing the entered text portion for auto-completion.
P 
P The entries other than the current one can be tagged by dropping the tag onto the entry items in the entry list.
P 
P  Creating tags
P Tags are crated by typing a unique tag name in the *Tag name* field below the entry view and clicking the *Create Tag* button that will show up when the entered text is not a name used before. Newly created tag will also be associated with the current entry.
P 
P  Tag categories
P Tags can _optionally_ be grouped into so called categories to help users manage the tag list when the number of the tags grows too big.
P 
P To add a tag to an existing or new category:
P 	• Click the tag in the tag list to open its view.
P 	•  From *Category* combo-box select *Create New...*

ID10003
E 2147483654
Dr1315863316
Dh1360176833
T stub
P Entries
P 
P Entries constitute the most essential part of a diary.
P 
P Entries can be time based or time independent. Time based entries are for recording notes related to a certain date like events happened on that day. they are normally sorted by date. Up to 1024 entries can be added to a particular date.
P 
P Time independent entries are for general notes, or any other idea not associated with a date. Time independent entries are grouped into ordinal chapters usually called _topics_.
P 
P  Creating entries
P Time based entries are created by double clicking a day in the calendar.
P Time independent entries are created using the dedicated button in the topic view.
P It is also possible to create a new entry on the current date by using *Today* button.
P 
P  Entry list
P Entries in the list are sorted by date by default. Order is from latest to earliest.
P It is also possible to have entries sorted 
P 	• by size, i.e. number of characters in them (from longest to shortest)
P 	• and by last save time (from newest to oldest).
P 
P  Text formatting
P First paragraph of an entry is formatted as heading.
P 
P Paragraphs starting with a space character (" ") are formatted as subheading.
P 
P Any text between
P 	• two asterisks ("*") are formatted as bold;
P 		e.g. Look at the *emphasized part* of the text!
P 	• two underscores ("_") are formatted as italic;
P 		e.g. Why do you _lean_ forward?
P 	• two equals signs ("=") are formatted as strike-through.
P 		e.g. =canceled out=
P 
P Refer to <deid:10022	Text Formatting> for a complete guide of text formatting.
P 
P  Comments
P There is a special markup type to denote comments in a text. Marking up comments this way has the benefit of toggling their visibility when needed. e.g. before taking a print out.
P 
P [[this is a comment]]
P 
P  Disabling markups in a paragraph
P Paragraphs starting with a dot (.) followed by a tab are ignored by the markup system:
P 
P .	*no bold* _no italic_ [[no comment]]
P 
P  Links
P It is possible to create links to other entries, dates, files, web sites, etc... in an entry. See <deid:10012	Links> for more info.
P 
P  Images
P Links to image files are automatically replaced by the thumbnail of the target image under following conditions:
P 	• link should be start with file:// or rel://
P 	• it should be placed in a dedicated paragraph i.e. there should be no other character in the paragraph other than link text, including space characters.
P 
P Please note that image files are not saved within diary files. Although they appear as images, they are still just links to external files.
P 

ID10021
E 2147483653
Dr1349518893
Dh1359487998
T stub
P Diary Elements
P 
P Diary elements are data blocks that holds different data types in a diary.
P Types of diary elements are
P 	• Entry,
P 	• Tag,
P 	• Tag Category,
P 	• Chapter,
P 	• Chapter Category,
P 	• Topic,
P 	• and Theme.
P 
P  Graphical interface
P Diary elements listed in left and right panels have its own _view_ for editing and management. <deid:10024	Active element panel> (central panel) displays the view of the currently selected element.

ID10004
E 2147483652
Dr1315863197
Dh1375515766
P Diaries
P 
P Lifeograph supports working with multiple diary files. It remembers previously opened diaries and offers a list of them at the startup for easy access.
P 
P  Creating a new diary
P Click *Create a New Diary...* button on the top of the diary list.
P 
P  Saving
P Diaries are saved automatically on log out. Previous version of the diary is also kept as a backup file. For more information about backups see <deid:10023	Backup Files>.
P Empty entries are ignored when saving.
P 
P  Diary view
P Diary view is opened by clicking the topmost item in the <deid:10024	entry list>.
P It allows the user
P 	• to add encryption to the diary
P 	• to change the password if the diary is already encrypted
P 	• to set spell checking language,
P 	• exporting and importing
P and some more.
P 
P  Encryption
P There are two types of diaries: plain and encrypted.
P To encrypt a diary, all that is needed to be done is adding a password to it.
P Lifeograph offers to add a password in the file dialog while creating a new diary. It is also possible to encrypt a plain diary afterwards via the *Encrypt..* item in the gear menu of the diary view.
P Encryption, once added, cannot be removed from a diary file. However, an unencrypted copy can be created via <deid:10025	export functionality>.
P 
P  Extension of diary files
P Default extension for diaries is *.diary* which will be appended automatically to the end of the name. This behavior, though, can be overridden via a <deid:10017	hidden option>.

ID10024
E 2147483651
Dr1341347350
Dh1375517143
P Interface (Editing)
P 
P rel://images/interface_legend.gif
P 
P 
P  1: Active element panel
P Central part of the editing interface shows the diary element currently selected be it an entry, a tag, or the diary itself.
P 
P The gear icon on the top right corner of this panel shows a menu with actions related to the active element.
P 
P  2: Main tool bar
P The tool bar above the entry list. It contains *Today*, *New*, *Tools*, and *Log out* buttons.
P 
P  3: Entry list
P Entry list show entries grouped by topics and chapters. The root item of the list (tree) is the diary itself.
P 
P All of the items in the list correspond to an <deid:10021	element> in the diary and when selected show the view of that element in the active element panel e.g. the root item shows the properties of the open diary.
P 
P  4: Calendar
P A standard Gtk+ calendar. Clicking a day shows first entry of that day, if any. Double-clicking creates a new entry.
P 
P  5: Tag and theme list
P Tags defined in the current diary are listed at the top grouped into categories. Below it, comes entry themes. Default theme is designated with a check mark icon.
P 
P  6: Filtering bar
P Here you can filter entries containing some text, favorite entries, and trashed entries. It is also possible to remove active date and tag filters using the dedicated button which is shown when such a filter is active.

ID10030
E 2147483650
Dr1375515844
Dh1377870352
T stub
P Interface (Login)
P 
P rel://images/login.gif
P 
P Login view allows one to choose the diary to open. It contains a list of previously opened diaries as well as standard diary files included in the package.
P 
P  Create New button
P Opens a file save dialog to enter the name, location, and optionally password for a new diary. Upon the completion of necessary info, an empty diary file will be opened.
P 
P  Open Another button
P Opens a file open dialog to select a diary file not available in the diary list.
P 
P  Diary List
P Contains previously opened diaries and system diaries which are Lifeograph Manual (this document) and an example diary file that also contains the release history of Lifeograph. System diaries are denoted with an asterisk in square brackets at the beginning of their names.
P 
P *TİP:* Clicking on the *Last Saved* column header of the list changes the column to display *Last Read* dates. This is useful for finding the diaries opened in read-only mode.
P 
P  Read and Edit buttons
P Diaries can be opened in editing mode for making changes or in <deid:10031	Read-Only Mode> which is a good way of making sure that nothing is changed inadvertently.
P System diaries can only be opened in read-only mode.

ID10009
E 2147483649
Dr1315862444
Dh1377869063
P Welcome to Lifeograph manual!
P document version: 1.0b
P 
P rel://images/interface.gif
P 
P  !!! WORK IN PROGRESS !!!
P 
P 
P 
P This manual is aimed at being a complete guide about Lifeograph.
P It is distributed with Lifeograph. You may find updated versions of it on <http://lifeograph.wikidot.com	the program's website>.
P 
P 
P 
P 
P 
P 

